feat(tui): add read-only transcript navigation - #110
Open
danielkov wants to merge 3 commits into
Open
Conversation
![kit-code-agent[bot]](https://avatars.githubusercontent.com/in/4797102?s=60&v=4){kind=small}
Contributor
There was a problem hiding this comment.
Three issues remain: viewport changes can restore a stale reveal anchor after automatic following resumes; slow navigator processing can discard deliberate Enter/Tab input; and oversized Unicode graphemes defeat the preview work and allocation bounds.
danielkov
commented
Sep 5, 2026
danielkov
force-pushed
the
feat/transcript-navigation
branch
from
September 5, 2026 23:27
d57cc27 to
4fb7a29
Compare
danielkov
force-pushed
the
feat/transcript-navigation
branch
from
September 6, 2026 09:28
b09a058 to
210e33b
Compare
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Add a read-only transcript navigator, opened with F3 or
/transcript, with text search, role filters, previews, and user-prompt jumps. Reveal the selected block without changing conversation history or the parked prompt.Impact
Navigation remains available while streaming and covers currently displayed or replayed history, not compacted archives. Search queries are limited to 4,096 UTF-8 bytes, and previews bound source consumption before Unicode segmentation.
Technical details
Stable selection within the active session
Selection uses ephemeral block identities separate from tool focus. Wrapped render offsets reveal the chosen block and preserve its position through resize until automatic following resumes; these display identities are not durable continuation addresses.
Input timing and overload safety
A dedicated terminal reader captures receipt times independently of rendering and searching, so delayed processing cannot turn pasted newlines into actions or discard deliberate input. Its queue bounds both event count and retained paste bytes. Overload discards pending input and requires quiet periods around an explicit Escape acknowledgement before controls become active again. The warning distinguishes waiting for quiet from readiness to acknowledge, and further input revokes readiness.
Linux terminal polling
Enable crossterm's
use-dev-ttybackend only on Linux to avoid reporting quiet while terminal bytes remain unread. This adds auditedfiledescriptor 0.8.3without upgrading existing packages; other platforms retain their current backend. Terminal stdin remains preferred, with/dev/ttyfallback for redirected stdin.